home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / spiele / gnuchess / doc / gnuchess.txt < prev    next >
Text File  |  1995-08-13  |  13KB  |  463 lines
  1.  
  2.  
  3.  
  4. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  5.  
  6.  
  7.  
  8. NAME
  9.      gnuchess - Chess
  10.  
  11. SYNOPSIS
  12.      gnuchess [ [[-]a] [-b bookfile] [-B binbookfile] [[-]h ] [-L
  13.      language]  [-r  length] [-s pathname] [-l pathname] [-S bin-
  14.      booksize] [-t] [-c size] [-T size] [-v] [-x] arg1 arg2 ]
  15.  
  16. DESCRIPTION
  17.      _G_n_u_c_h_e_s_s plays a game of chess against the user or it  plays
  18.      against itself.
  19.  
  20.      _G_n_u_c_h_e_s_s is an updated version of the GNU chess playing pro-
  21.      gram.   It  has a simple alpha-numeric board display, an IBM
  22.      PC compatible interface, or it can be compiled for use  with
  23.      the  chesstool  program  on  a  SUN  workstation or with the
  24.      xboard program under X-windows.  To invoke the program type:
  25.  
  26.      gnuchess
  27.           - simple curses based version
  28.  
  29.      gnuchessn
  30.           - fancy version using curses and inverse video on UNIX,
  31.           or IBM PC cursor controls and characters on MSDOS
  32.  
  33.      gnuchessr
  34.           - ASCII based version
  35.  
  36.      gnuchessc
  37.           - chesstool compatible version
  38.  
  39.      gnuchessx
  40.           - xboard compatible version
  41.  
  42. TIME CONTROLS
  43.      If one argument is given, it is the search time per move  in
  44.      [minutes:]seconds.   So  gnuchess  30 will generate one move
  45.      every 30 seconds, while gnuchess 5:00 will generate one move
  46.      every 5 minutes.
  47.  
  48.      If two or more arguments are given, they will be used to set
  49.      tournament  time  controls  with  the first argument of each
  50.      pair being the number of moves  and  the  second  being  the
  51.      total  clock time in minutes[:seconds].  Thus, entering gnu-
  52.      chess 60 5 will set the clocks for 5 minutes  (300  seconds)
  53.      for  the  first  60 moves, and gnuchess 30 3:30 will allow 3
  54.      minutes and 30 seconds for 30 moves.
  55.  
  56.      gnuchess 30 5 1 :30 will allow 5 minutes for  the  first  30
  57.      moves  and  30  seconds  for  each move after that.  Up to 4
  58.      pairs of controls may be specified.
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  71.  
  72.  
  73.  
  74.      If no argument is given the program will prompt the user for
  75.      level of play.
  76.  
  77.      For use with chesstool or xboard, see the  documentation  on
  78.      those programs.
  79.  
  80. BOOK
  81.      At startup _G_n_u_c_h_e_s_s reads the _b_i_n_b_o_o_k file if it is present.
  82.      It  then looks for a _b_o_o_k file. If it is present it adds its
  83.      contents to the _b_i_n_b_o_o_k data. If the _b_i_n_b_o_o_k file  is  writ-
  84.      able a new combined _b_i_n_b_o_o_k file is written.
  85.  
  86.      The book _g_n_u_c_h_e_s_s._b_o_o_k consists of a sequence  of  openings.
  87.      An  opening  begins with a line starting with a ! , the rest
  88.      of the line is comments.  Following  this  is  a  series  of
  89.      moves  in  algebraic  notation  alternating  white and black
  90.      separated by white space. A move may have a ? after it indi-
  91.      cating  this  move  should  never  be made in this position.
  92.      Moves are stored as position:move so transpositions  between
  93.      openings can take place.
  94.  
  95. HASHFILE
  96.      The hashfile if created should be on the order  of  4  mega-
  97.      bytes  or  gnuchess  -c 22. This file contains positions and
  98.      moves learned from previous games. If a hashfile is used the
  99.      computer  makes  use  of  the  experience  it gained in past
  100.      games. Tests run so far show that it plays no worse with the
  101.      hashfile  than  without,  but it is not clear yet whether it
  102.      provides a real advantage.
  103.  
  104. LEGAL MOVES
  105.      Note: Piece letters and legal castling  notation  is  deter-
  106.      mined  by  the language file.  What is specified here is the
  107.      default English.
  108.  
  109.      Once _g_n_u_c_h_e_s_s is invoked, the program will display the board
  110.      and  prompt  the  user  for a move. To enter a move, use the
  111.      notation e2e4 where the first letter-number  pair  indicates
  112.      the  origination  square  and  the second letter-number pair
  113.      indicates the destination square.  An alternative is to  use
  114.      the  notation nf3 where the first letter indicates the piece
  115.      type (p,n,b,r,q,k).  To castle, type the origin and destina-
  116.      tion  squares of the king just as you would do for a regular
  117.      move, or type o-o or 0-0 for kingside castling and o-o-o  or
  118.      0-0-0  for  queenside.  To promote a pawn append the type of
  119.      the new piece to the move, as in e7e8q or c7c8r.
  120.  
  121. FUNCTION LETTERS
  122.      -L lang
  123.           Use language _l_a_n_g _f_r_o_m _t_h_e _f_i_l_e gnuchess.lang. If -L is
  124.           not  specified  it defaults to the language used in the
  125.           first line in the file. gnuchessr -L ger will  use  the
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  137.  
  138.  
  139.  
  140.           german language.
  141.  
  142.      -a   Do not search on opponents time.
  143.  
  144.      a    Do search on opponents time.
  145.  
  146.      -b bookfile
  147.           Use bookfile for opening book.
  148.  
  149.      -B binbookfile
  150.           Use binbookfile for binary opening book.
  151.  
  152.      -S size
  153.           Size of binbookfile for memory based and GDX books. For
  154.           creating a binbookfile.
  155.  
  156.      -P plylevels
  157.           Number of plys to include in the binbookfile. For  gen-
  158.           erating a binbookfile.
  159.  
  160.      -c size
  161.           Create a new HASHFILE. File size is 2^size  entries  of
  162.           approximately 65 bytes.
  163.  
  164.      -h   Do not use hashfile.
  165.  
  166.      h    Do use hashfile.
  167.  
  168.      -l pathname
  169.           Pathname of the loadfile use with the get or xget.
  170.  
  171.      -r length
  172.           Rehash length times in searching  entries for  position
  173.           in transposition table.
  174.  
  175.      -s pathname
  176.           Pathname of the save file to use with the save command.
  177.  
  178.      -t   Show statistics for HASHFILE
  179.  
  180.      -T size
  181.           Set the  transposition  table  size  to  size  entries.
  182.           (minimum is MINTTABLE)
  183.  
  184.      -v   Show version and patchlevel.
  185.  
  186.      -x value
  187.           Use value as the evaluation window xwndw.
  188.  
  189. COMMANDS
  190.      In addition to  legal  moves,  the  following  commands  are
  191.      available  as responses.  Note: command names are determined
  192.  
  193.  
  194.  
  195. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  203.  
  204.  
  205.  
  206.      by the _l_a_n_g_u_a_g_e file and may vary with  the  implementation.
  207.      This is default English.
  208.  
  209.      alg -- allow algebraic input (not implemented)
  210.  
  211.      Awindow -- change Alpha window (default score + 90)
  212.  
  213.      Bwindow -- change Beta window (default score - 90)
  214.  
  215.      beep -- causes the program to beep after each move.
  216.  
  217.      bd -- updates the current board position on the display.
  218.  
  219.      book -- turns off use of the opening library.
  220.  
  221.      both -- causes the computer to play both sides  of  a  chess
  222.      game.
  223.  
  224.      black -- causes the computer to take the black  pieces.   If
  225.      the computer is to move first the go command must be given.
  226.  
  227.      coords -- show coordinates on the display (visual only)
  228.  
  229.      contempt -- allows the value of _c_o_n_t_e_m_p_t to be modified.
  230.  
  231.      debug --  asks for a piece as color piece, as wb or bn,  and
  232.      shows its calculated value on each square.
  233.  
  234.      debuglevel --  sets level of debugging  output  if  compiled
  235.      with debug options.
  236.  
  237.      depth -- allows the user to change the search depth  of  the
  238.      program.   The  maximum depth is 29 ply.  Normally the depth
  239.      is set to 29 and the computer terminates its search based on
  240.      elapsed  time rather than depth.  If depth is set to (say) 4
  241.      ply, the program will search until all moves have been exam-
  242.      ined  to  a  depth  of 4 ply (with extensions up to 11 addi-
  243.      tional ply for sequences of checks and captures). If you set
  244.      a  maximum time per move and also use the depth command, the
  245.      search will stop at the  specified  time  or  the  specified
  246.      depth, whichever comes first.
  247.  
  248.      easy -- toggles easy mode (thinking on  opponents  time)  on
  249.      and  off. The default is easy mode ON.  If easy mode is dis-
  250.      abled, the keyboard is polled for input every so  often  and
  251.      when  input is seen the search is terminated. It may also be
  252.      terminated with a _s_i_g_i_n_t.
  253.  
  254.      edit -- allows the user to set up a board position.
  255.  
  256.           # - command will clear the board.
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.1           Last change:                          4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  269.  
  270.  
  271.  
  272.           c - toggle piece color.
  273.  
  274.           . - command will exit setup mode.
  275.  
  276.         pb3 - place a pawn on b3
  277.  
  278.      Pieces are entered by typing a letter (p,n,b,r,q,k) for  the
  279.      piece followed by the coordinate.
  280.  
  281.      The usual warning about the _l_a_n_g_u_a_g_e _f_i_l_e applies.
  282.  
  283.      exit -- exits gnuchess.
  284.  
  285.      first -- tells the computer to move first.  Computer  begins
  286.      searching for a move.  (same as "go").
  287.  
  288.      force -- allows the user to enter moves for both  sides.  To
  289.      get  the  program to play after a sequence of moves has been
  290.      entered use the 'white' or 'black' command followed by 'go'.
  291.  
  292.      gamein -- toggles game mode time control. Assumes  the  time
  293.      specified  for time control is the time for a complete game.
  294.      Input with the level command should be the game time and the
  295.      expected number of moves in a game.
  296.  
  297.      get -- retrieves a game from disk.  The program will  prompt
  298.      the user for a file name.
  299.  
  300.      hash -- use/don't use hashfile.
  301.  
  302.      hashdepth -- allows the user to change the minimum depth for
  303.      using the hashfile and the number of moves from the begining
  304.      of the game to use it.
  305.  
  306.      help -- displays a short description of the commands and the
  307.      current status of options.
  308.  
  309.      go -- tells the computer  to  move  first.  Computer  begins
  310.      searching for a move.  (same as "first").
  311.  
  312.      hint -- causes the program  to  supply  the  user  with  its
  313.      predicted move.
  314.  
  315.      level -- allows the user to set time  controls  such  as  60
  316.      moves  in  5  minutes  etc.  In tournament mode, the program
  317.      will vary the time it takes for each move depending  on  the
  318.      situation.   If easy mode is disabled (using the 'easy' com-
  319.      mand), the program will often respond with its move  immedi-
  320.      ately, saving time on its clock for use later on.
  321.  
  322.      list -- writes the game moves and some statistics on  search
  323.      depth, nodes, and time to the file 'chess.lst'.
  324.  
  325.  
  326.  
  327. Sun Release 4.1           Last change:                          5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  335.  
  336.  
  337.  
  338.      material -- toggle material flag - draws  on  no  pawns  and
  339.      both sides < rook
  340.  
  341.      Mwpawn, Mbpawn, Mwknight, Mbknight,  Mwbishop,  Mbbishop  --
  342.      print out static position evaluation table
  343.  
  344.      new -- starts a new game.
  345.  
  346.      p -- evaluates the board and shows the point score for  each
  347.      piece.  The  total  score for a position is the sum of these
  348.      individual piece scores.
  349.  
  350.      post -- causes the program to display the  principle  varia-
  351.      tion  and  the  score  during the search.  A score of 100 is
  352.      equivalent to a 1 pawn advantage for the computer.
  353.  
  354.      quit -- exits the game.
  355.  
  356.      random -- causes the program to randomize its move selection
  357.      slightly.
  358.  
  359.      rcptr -- set recapture mode.
  360.  
  361.      remove -- backout the last level for both sides. Equal to  2
  362.      _u_n_d_o'_s.
  363.  
  364.      reverse -- causes the board display to  be  reversed.   That
  365.      is,  the  white  pieces  will  now  appear at the top of the
  366.      board.
  367.  
  368.      rv -- reverse board display.
  369.  
  370.      setup -- Compatibility with Unix chess and  the  nchesstool.
  371.      Set  up  a  board position.  Eight lines of eight characters
  372.      are used to setup the board. a8-h8 is the first line.  Black
  373.      pieces are  represented  by  uppercase characters.
  374.  
  375.      stars -- (gnuchessn only) add stars (*) to black pieces.
  376.  
  377.      save -- saves a game to disk.  The program will  prompt  the
  378.      user for a file name.
  379.  
  380.      switch -- causes the  program  to  switch  places  with  the
  381.      opponent and begin searching.
  382.  
  383.      test -- performs some speed tests for MoveList and CaptureL-
  384.      ist  generation,  and ScorePosition position scoring for the
  385.      current board.
  386.  
  387.      time otim -- time set computers time remaining, intended for
  388.      synchronizing  clocks  among  multiple players.  -- otim set
  389.      opponents time remaining, intended for synchronizing  clocks
  390.  
  391.  
  392.  
  393. Sun Release 4.1           Last change:                          6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. gnuchess(6)              GAMES AND DEMOS              gnuchess(6)
  401.  
  402.  
  403.  
  404.      among multiple players.
  405.  
  406.      undo -- undoes the last move whether it was  the  computer's
  407.      or  the  human's.  You  may  also  type  "remove".  This  is
  408.      equivalent to two "undo's" (e.g. retract one move  for  each
  409.      side).
  410.  
  411.      white -- causes the computer to take the white  pieces.   If
  412.      the computer is to move first the go command must be given.
  413.  
  414.      xget -- read an _x_b_o_a_r_d position file.
  415.  
  416.      xwndw -- change X window. The window around alpha/beta  used
  417.      to  determine  whether the position should be scored or just
  418.      estimated.
  419.  
  420. BUGS
  421. SEE ALSO
  422.      chesstool(6)
  423.      xboard(6)
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459. Sun Release 4.1           Last change:                          7
  460.  
  461.  
  462.  
  463.